OstreeMutableTree: Document each private member of `OstreeMutableTree`
authorWilliam Manley <will@williammanley.net>
Fri, 22 Jun 2018 10:37:37 +0000 (11:37 +0100)
committerAtomic Bot <atomic-devel@projectatomic.io>
Mon, 25 Jun 2018 16:22:21 +0000 (16:22 +0000)
commitca8571a49b1719887b06017a6c77798bb7f3bb6b
tree689ba6c46150fd0f760f0286b8d5661442f89c7c
parente120a6b1198aaa785533c76316898f15a804dae1
OstreeMutableTree: Document each private member of `OstreeMutableTree`

A prelude to my understanding.  Unfortunately `OstreeMutableTree` provides
little encapsulation, as each member has setters† so it's difficult to come
up with a list of invariants.

† `files` and `subdirs` only have getters, but the getters return mutable
  references to the internals, so we still can't reason about invariants.

Closes: #1645
Approved by: jlebon
src/libostree/ostree-mutable-tree.c